home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbiowdesc.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.0 KB  |  58 lines
  1. .Na "DBIOWDESC    (UNIX only)"
  2. .Aa
  3. .Fu
  4. Provide program access to the UNIX file descriptor used by a
  5. DBPROCESS to write data to \*S.
  6. .Ih "file descriptor (UNIX), access to"
  7. .Sy
  8. .Sf "int DBIOWDESC(dbproc)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Co
  11. .Bl
  12. This routine provides a way for an application to 
  13. effectively utilize multiple input and output streams.
  14. .Ih "input streams, multiple"
  15. .Ih "output streams, multiple"
  16. Depending on the nature of your application,
  17. the time interval between the initiation of an attempt to write 
  18. information to \*S (usually made via a call to \f2dbsqlsend()\fP)
  19. and the completion of that attempt may be significant.
  20. You may use this
  21. time to service other parts of your application. The \f2DBIOWDESC()\fP
  22. routine provides a way to obtain the I/O descriptor which a DBPROCESS uses
  23. to write the data stream to \*S.
  24. This information
  25. may then be used with various operating system facilities 
  26. (such as the UNIX \f2select()\fP function)
  27. to allow the application to effectively utilize multiple input and output streams.
  28. .Bl
  29. The file descriptor returned by this routine may only be used with operating system
  30. facilities that \f2do not\f1 write data to the outgoing data stream. If data
  31. is written to this stream by any means other than through a \*L routine, 
  32. communications between the front-end and \*S will become hopelessly scrambled.
  33. .Bl
  34. A companion routine, \f2DBIORDESC()\f1, provides access to the file descriptor
  35. used to read data coming from \*S.
  36. .Bl
  37. For an example that illustrates the use of \f2DBIOWDESC()\f1 with \f2dbsqlsend()\f1
  38. and \f2dbsqlok()\f1, see the \f2\*L Reference Supplement\f1.
  39. .Bz
  40. .Pa
  41. .Pi dbproc
  42. A pointer to the DBPROCESS structure that provides the connection
  43. for a particular front-end/\*S process.  It contains all the
  44. information that \*L uses to manage communications and data between the
  45. front end and \*S.
  46. .in -.375i
  47. .Re
  48. .br
  49. An integer file descriptor used by the specified DBPROCESS to write data to
  50. \*S.
  51. .Sa
  52. dbcmd, 
  53. DBIORDESC, 
  54. dbnextrow, 
  55. dbresults, 
  56. dbsqlok, 
  57. dbsqlsend
  58.